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PREFACE 
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SUBSCRIPT 11.5 ELEMENTS 


NAMES 


Examples 

Combination of letters, digits and periods arranged 


as follows: 


X 

— contains at least one letter or WAITING.LINE 

— contains digits and at least two non-terminal 


periods. 


IB 

— cannot be broken across card boundaries. 

1.2.3 

I 


1.5E15 

CONSTANTS 


Examples 

Integer 

Combination of up to 18 digits 

2 

347 

314159265 

Real 

Combination of up to 15 digits 

3.14 


containing at least one period 

1. 



.759 

String 

Sequence of characters enclosed 
within ”. 

“ABCD” 

Text 

Sequence of characters enclosed 
within 1. 

ITEXT IS: 1 

VARIABLES 



Integer 

Range-(259 -1)to 259 -1. Asa 
result of multiplication or division 
or conversion from real to integer, 
or integer to real, maximum value 
is 248-1. 


Integer packed 

j 

. Bit packed (n-m) 

1 < n < m < 60 
. Field packed (n/m) 
m = 2, 3,4, 5, 6,10,12,15 
n = 1 to m 
. Intra-packed (*/m) 
m = 2,3,4,5,6,10,12,15 


Real 

Range 10 -293 to 10 +322 
(approximately 15 significant digits) 


i Alpha 

Up to 10 characters for a replacement 
statement. 
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SOURCE LANGUAGE 


NOTATION 

The notation employed in describing SIMSCRIPT II.5 is a combina¬ 
tion of conventions used in several computer programming language 
descriptionsj In the following pages: 

1. Words in capital letters are statement keywords. 

2. Primitives shown in italics are basic language constructs. They are: 

mme 
integer i 
number n 
string s 
text t 

3. A metavariable denotes an occurrence of an element of the type 
represented by the metavariable symbol shown in italics. 

4. A statement is a combination of keywords, primitives, and meta¬ 
variables that follows a certain pattern, called the syntax of the 
statement. 

5. Brackets [ ] and braces \ } denote choices. When brackets appear, 
a choice may be made from the options indicated. When braces 
appear, a choice must be made. The items available for selection 
appear in a vertical list within the brackets or braces. When a 
choice can be repeated, a symbol (or symbols) that must separate 
the items in the list of choices is written at the upper right-hand 
corner of the brackets or braces. For example, if a choice appears 

as | g [ the sequence a,a,b,a, ..b might be selected. The choice 
represented by j A ^ ' is logically equivalent to A [,A j [,a] . . . [,A]. 

6. The null character £ is used to indicate that no symbol need 
separate the items in a list of choices. An example of j- ^ might 
be AABABB ... A. The choice represented by |a J s is logically 
equivalent to a [a ] [a ] . .. [a ]. 

7. A list separator symbol can itself be complex, involving choices 

JANDI 

and repetitions, as in | gP 0R ’ an instance of which might be 
A AND B OR A OR B. 

8. Plural keywords ending in s such as variables and LINES, can 
be written in singular form as VARIABLE or LINE when called for 
by the grammar of a statement. 
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SYMBOLS 


letter = 
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character = 


letter 

special character , 
digit 
blank 
period 


\ 



period = 


3 



METAVARIABLES 


arithmetic expression e 



comma c = 


,AND > 
AND ) 


i phi use for = 


.EACH , ( name 

'L.J ) 


e TO e iBYf] 
[CALLED namc\ 


r 


1 FROM 1 

I AFTER | C 

jONl l ’ llN REVERSE ORDER] 1 

L 

-1 AT ■ 




EACH name IN THE DICTIONARY 


format f l 



format fo 


i Ce 
i I e 
i A e 
i D ( e,e } 
i E { e,e) 
iTe 


label l 


f name ') 
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logical 

expression 0 - 


( 


{*) 

e {(tSl S2e} s 

(positive ) 

e IIS] [NOT] < NEGATIVE > 
(ZERO ) 

(real ) 

MODE [IS] [NOTH INTEGER > 
(ALPHA ) 

DATA [IS] [NOT] ENDED 
CARD [IS] [NOT] NEW 
PAGE [IS] [NOT] FIRST 

[this] vIISIINOTI EMPTY 



[™ S > IS ' N0T ' IN 


r A i 

AN 

THE 

Lsome-1 


name 


| ^ EVENT IS [NOT] 


/INTERNAL n 
)EXTERNAL I 
)ENDOGENOUS f 
^EXOGENOUS ) 


/ 


I 


relational 
operator £2 = 


/ (EQUALto 1 ) 

1 ) EQUALS \ 

1“ ) 


NOT EQUAL TO) 

T- 


GREATER THAN 
GR 
GT 
> 

NOT GREATER THAN 
NO GREATER THAN 
LE 

< = 

NOT LESS THAN 
NO LESS THAN 
GE 
> = 


routine/ 1 = 'name’ 


selection clause sc 


WITH 

[EXCEPT] WHEN 
UNLESS 


0 U 
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termination clause tc 


(while! , 

= 1 UNTIL I 4, 


variable v = name 


<*}■[,{*}'] 

<*>’ 


/ t 

i name 
word w = ( n 

I special character 
\ s 

Words must be separated from each other by 
one or more blanks unless they are special 
characters. 

Periods ( .) are ignored between words and at 
the end of statements. 

Comments can be inserted between any two 
words in a program by enclosing them in 
quote marks (”) formed by two consecutive 
apostrophes. The right-hand set of quotes is 
not necessary if the comment is the last item 
on a card. 
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LANGUAGE STATEMENTS 


v{* S } [TH E ][ rame ] 


accumulate/ 1 


TALLY 


S 


/AVERAGE 
' AVG 
MEAN 
SUM 

NUMBER 
l NUM 

1 VARIANCE 
I VAR 

f STD. DEV 

) STD 
SUM.OF.SQUARES | 
SSQ 

MEAN.SQUARE 

MSQ 

MINIMUM 

MIN 

MAXIMUM 
[ MAX 


>0 F 


name (n TO n BY n ) ^THeJ | ~nam^ HISTOGRAM j 

Specifies automatic data collection and analysis for named variables. 


/SCHEDULE 
\ ACTIVATE 
\CAUSE 

/reactivate 

(.RESCHEDULE, 


GJ 

[THE [ABOVE]' 

Ithis 


^CALLED vj 



( DAYS ) 
UNITS f 
HOURS f 

minutes; 


Files an event notice in the events set according to its time. 
ADD e TO v 

Adds the value of the value of the variable v. 

(ADVANCE ) (INPUT M FILES ) 

i > e W > USING 

I BACKSPACE( OUTPUT RECORDS j 
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BEFORE 

AFTER 



CREATING 

DESTROYING 


FILING 

REMOVING 


CAUSING 

CANCELING 


A 

AN 

THE 

ANY_ 

IN 

FROM 

'A 

AN 

THE 

_ANY_ 


name 


name 


name 


, ] CALL name 


Specifies a call to a named routine whenever the indicated statement is 
executed. Inputs to the routines are: 



BEFORE 

AFTER 

CREATE 

Not allowed 

Entity identifier 

DESTROY 

Entity identifier 

Not allowed 

CAUSE 

Entity identifier, time 

Entity identifier, time 

CANCEL 

Entity identifier 

Entity identifier 

FILE 

Entity identifier, subscripts 

Entity identifier, subscripts 

REMOVE ! 

Entity identifier, subscripts 

_ . 

Entity identifier, subscripts 


[ALSO] 


jfory 
l/c j 


~for~ 

5? 

tc 

DO 

_ se _ 



THIS 

THE FOLLOWING 


Logical phrases control the execution of statements that follow them. When 
more than one statement is to be controlled, the word DO precedes them. 
Multiple control phrases terminating control on the same LOOP statement are 
preceded by the word ALSO. 


(ALWAYS \ 
t REGARDLESS) 

Synonyms indicating the transfer point of the false condition of a preceding 
IF statement. 


BACKSPACE - See ADVANCE 


BEFORE — See AFTER 


BEGIN HEADING 

Marks the beginning of a heading block within a report section. 
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BEGIN REPORT [ON A NEW PAGE] [PRINTING for IN GROUPS OF i 
[PER PAGE]] 

Marks the beginning of a report section. 


. (HIGH] ( c THEN 

BREAK name TIES { BY < LQW > name > 

Establishes a priority order within an event class. 


[perform} 

nCALL > name 

(now ) 


THE 

THIS v , 
GIVEN ( \ e i 
GIVING ^ 


(M c ) 


YIELDING {v} £ 


CMs a routine used as a procedure. Both input GIVEN and output 
YIELDING argument lists are optional. 


CANCEL 

THE [ABOVE] 

THIS 

name 

CALLEDv 


Removes a scheduled event notice from the event set. 

CAUSE - 

- See ACTIVATE 




\ CLOSE j 

[tape] 

1 ENDFILE S 

’[unitJ 


Writes an end-of-file mark on an output device. 


4 


4 
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COMPUTE 


/ 


-OH 


\ 




AVERAGE 

AVG 

MEAN 

SUM 

NUMBER 

NUM 

VARIANCE 

VAR 

STD.DEV 
STD 

SUM.OF.SQUARES 

SSQ 

MEAN.SQUARE 

MSQ 

MINIMUM ( e ) 

MIN (e) 
MAXIMUM (e) 
MAX( e) 
MINIMUM 
MIN 

MAXIMUM 

MAX 


c 


OF e 


Must be controlled by a logical control phrase. Computes the indicated 
statistics of the expression e after the LOOP statement if the 
control is over a DO. . .LOOP block. 


\ DESTROY 
( CREATE 


[;.] 


name [CALLED v] 


EACH ] ( 

ALL > \ name [( e )] 

every) { 


jCYCLE) 
j NEXT \ 

A control statement. 
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, r FIF o - ! ( ('HIGH'l 

DEFINE] name } AS [A] SETS RANKED^ BY < V, 

{ * L LIF0 J ( ^LOWj 


WITHOUT jg> ATTRIBUTES [,] WITHOUT(RF) ROUTINES 


Defines set ranking, owner and member attributes and generated set 
processing routines. 


DEFINE {name 


) c A 
4 AS 
J [_AN_ 


(INTEGER^ 

) ALPHA I 
i REAL ( 

Itext ) 

RELEASABLE 

FORTRAN 


GIVING) 
GIVEN > i 
WITH j 


ARGUMENTS 


DEFINE | name \ C AS 


INTEGER 
STREAM i 
REAL 


DEFINE {name? AS 


SIGNED INTEGER j 
INTEGER ( 

ALPHA ) 

REAL \ 

TEXT ) 

(DIMENSIONAL) 


ANJ DUMMY 

SUBPROGRAM 
FORTRAN 
EXTENDED 
( SAVED 1 
- \ RECURSIVE J 


MONITORED ON 


Define properties of global and local variables, and routines. 
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DEFINE w TO MEAN { w } 55 

Instructs the compiler to substitute the words (up to the end of the card on 
which the statement appears) following the keyword MEAN for the indicated 
word in all subsequent statements, before they are compiled. 


DESTROY — See CREATE 


DO — See ALSO 


(ELSE l 
(OTHERWISE) 

Synonyms indicating the transfer point of the false condition of a 
preceding IF statement. 

END 

Maries the end of a program preamble, routine, report section, and heading 
block of a report section. 

ENTER WITH v 

Used to transfer a u right-hand“ value to a left-handed function. 


UPON ) 

> name 
EVENT) 


I THE ) 

)this 

x GIVEN ( x 

giving) 


L({*} c ) J 


[saving THE EVENT NOTICE 


Event declaration. Unless SAVED, an event notice is destroyed before an 
event routine is executed. 


EVENT NOTICES ^INCLUDE {name} ] 
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i 


EVERY \ name \ ° 
THE SYSTEM 


MAY' 

CAN. 






Entity-attribute-set structure declaration. Specifies attribute packing, equivalence, 
word assignment and function options. 


(ENTITIES) , , c 

EXTENDED \ } INCLUDE ( name) 

(ARRAYS ) 1 

Defines extended memory data structures. 


(EXTERNAL WEVENT j UN.TS ARE i™™) ' 
(exogenous/ (PROCESS/ (i ) 

Names units from which external event data will be read. 


EXTERNAL WEVENTS 
EXOGENOUS/ (PROCESSES 



c 


Declares the names of events that can be triggered externally. 



FIRST 



[the] 

FILE \e 

LTHISJ 

LAST 

IN 

THE 

/before) 


_THIS_ 


{AFTER J e 




Files an entity in a set. 

jTif / F0UND 1 [ ] 

(NONE / 1,1 

Must be controlled by a logical control phrase, but cannot be within a 
DO...LOOP block. The optional IF phrase directs control after the control 
phrase has been completed, depending upon the “success” of the FIND. 


FIND 


THE FIRST CASE 
v = [THE] [FIRST] e}‘ 


FOR — See ALSO and for metavariable 
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ROUTINE 

FUNCTION 

SUBROUTINE 



(THE \ 

( 1 


)this ( 


l c 

) GIVING ( 
vGIVEN J 

\ name 



/ c \ 
{{name} j 


[YIELDING {name} C ] 

Subprogram declaration. Routines used as functions only have GIVEN 
arguments. If LEFT or RIGHT are not stated, RIGHT is implied. 


<=n 

Controls the generation of LIST ATTRIBUTES routines for entities. By 
default, no LIST routines are generated. 


GO [TO] 


(*[(«)]') 
(/[(e)] j 


Transfers control to the indicated label. 


GO [TO] 




PERe 


Transfers control to the n* label in the label list according to the integer 
value of the transfer expression e. 


HERE — A control statement 


IF 0[,] — See 0 metavariable 


INTERRUPT name [CALLED v] 


(ahead) 

JUMP < > 

(BACK j 

A control statement. 

‘/[(or 

A statement label identifies a transfer point. 
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LAST COLUMN 



Characters beyond column / are ignored on subsequent cards. 


LEAVE — A control statement. 


LET v = e 

Assigns the value of e to the variable v. 

If v is integer and e is real, the result is rounded before storing. 


LIST 


e 

ATTRIBUTES OF 


name [CALLED e ] 
EACH name [OF v] 


c 


A free-form output statement that labels and displays values of expressions 
and 1- and 2-dimensional arrays. 


(LOOP ) 

(REPEAT/ 

Used with DO to delimit a group of statements controlled by one or more 
logical control phrases. 

MAIN 

Marks the beginning of a program’s main routine. Execution commences at 
the first executable statement after MAIN. 


>•« p: ■} 

Used within a routine defined for a monitored variable to access or set the 
value of the variable. 


NEXT - See CYCLE 


OTHERWISE - See ELSE 
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normally [ 


f IS 

MODE 


TYPE 


! TEXT ) 

INTEGER^ 
REAL ( 
ALPHA j 

/SAVED \ ) 
| RECURSIVE) 


/dimension/ fis\. 
/dim f \-> 1 


Establishes background conditions for properties of variables and functions 
that are effective unless overridden by subsequent DEFINE declarations or, 
in the case of local arrays, first use. , 


NOW — See CALL 


PERFORM — See CALL 



PREAMBLE 


Maries the beginning of the program preamble. 


PRINT / [DOUBLE] LINES 


WITH 


[ e 

|A GROUP OF je | c FIELDS 



SUPPRESSING FROM COLUMN i 


LIKE THIS 
THUS 

AS FOLLOWS 


The i lines following the PRINT statement are format lines containing text 
and pictorial formats for the display of indicated expression values. The phrases 

A GROUP OF |e \ c FIELDS and SUPPRESSING FROM COLUMN / 
can only be used within report sections that have column repetition. 


PRIORITY ORDER IS {name) c 

Assigns a priority order to different classes of events. 
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PROCESS name 



(^{name} ) 


PROCESSES INCLUDE {name) 


REACTIVATE — See ACTIVATE 



USING 


THE BUFFER ' 



Used without an AS clause indicates a free-form data input. 


RECORD 


MiEMORY 

STATUS 


REGARDLESS — See ALWAYS 


RELEASE {v} C 

Releases blocks of core pointed to by v; v’s are assumed to be pointer variable 


RELINQUISH e [UNITS OF] name [(e)] 



Removes an entity from a set. 
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REPEAT — See LOOP 


REQUEST e [UNITS OF] name [(e )3 [,WITH PRIORITY e] 

RESCHEDULE - See ACTIVATE 
RESERVE |{v} C as {e} [BY*]| 

Allocates blocks of core of specified size to the pointer variables v. Words 
assigned are dat a if no BY* phrase appears, and are pointe rs otherwise. 

RESET [THE] [name] TOTALS OF | v} 

Initializes ACCUMULATE or TALLY counters associated with v. If 
TOTALS is not qualified by a word, all counters of v are initialized. 

RESOURCES [iNCLUDE {name} ] 

RESUME name [CALLED v] 

{s“s} substitution 

I Used to override a currently defined substitution. This statement must not 
h be placed on program cards with other statements. 

1; RETURN [{mne}] 

II Used as a procedure, a routine returns control to its calling program with the 

| statement RETURN; used as a function, a routine returns control and a value 

j|j to its calling program by either of the statements RETURN (e) or RETURN 

III WITH e 
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REWIND 


TAPE 
UNIT ^ 

Rewinds an input/output device. 


ROUTINE — See FUNCTION 


SCHEDULE — See ACTIVATE 


SKIPe 


FIELDS 

INPUT 

OUTPUT 


CARDS | 
LINES } 

records; 


Applies to the current input or current output unit. SKIP e FIELDS applies 
to the current input unit only when it is used for freeform data input. 
CARDS, LINES, and RECORDS are synonyms. If neither UNPUT nor 
OUTPUT is specified, INPUT is implied. 



Applies to the current input or current output unit. LINE, CARD, and 
RECORD are synonyms. If neither INPUT nor OUTPUT is specified, 
INPUT is implied. 


START SIMULATION 

Starts simulation by removing the first event from the events set and 
executing it. 

STOP 

Halts program execution. 


STORE e IN v 

Assigns a value to a variable without mode conversion. 
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SUBROUTINE — See FUNCTION 


SUBSTITUTE j™ S g E j i LINES FOR w 

Similar to DEFINE TO MEAN but allows more than one card of 
words to be substituted. 

SUBTRACT e FROM v 

Subtracts the value of e from the value of the variable v. 

SUPPRESS — See RESUME 
SUSPEND [PROCESS] 

The suspend statement may only appear in a process routine. The process is 
placed in the passive state. 

[THE] SYSTEM 
See EVERY 

TALLY - See ACCUMULATE 

be permanent or 


[THEN] IF 0 [,] 

See IF 

[TAPE 

TRACE USING 

[UNIT 

Produces a backtrack of current subprogram calls. When the SIMSCRIPT II 
operating system uses TRACE the standard output device (printer) is used. 



TEMPORARY ENTITIE! 


PERMANENT ENTITIES' 


^INCLUDE | name } 


Declares the type of following EVERY statements to 
temporary, as the case may be. 


THE SYSTEM — See EVERY 
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UNLESS — See tc metaraviable (termination clause) 


UNTIL — See sc metavariable (selection clause) 


UPON - See EVENT 


1 

j' THE BUFFER) 

1 

i INPUT ) 

USE < 
( 

ira* i 

FOR <j 

' \ 

1 OUTPUTj 


Sets the indicated input/output device as the current input or output unit. All 
subsequent input/output statements that do not specify their own devices in 
USING phrases use these current units. THE BUFFER causes reading and 
writing in an internal file. 



' UNIT \ 

(WORK) 

1 DAYS ( 

(WAIT ) 

j HOURS f 


( minutes) 


WHEN — See sc metavariable (selection clause) 


WHILE — See tc metavariable (termination clause) 


WITH —* See sc metavariable (selection clause) 


WORK - See WAIT 
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Attributes and Routines Required for Set Statements 


SET 

STATEMENT 


ATTRIBUTES 

REQUIRED 


FILE FIFO 
FILE LIFO 
FILE ranked 
FILE FIRST 
FILE LAST 
FILE BEFORE 
FILE AFTER 

REMOVE FIFO 
REMOVE LIFO 
REMOVE ranked 
REMOVE FIRST 
REMOVE LAST 
REMOVE specific 

set IS EMPTY 
IS IN set 

FOR EACH...OF set 
FOR EACH...OF set 
...REVERSE 
FOR EACH...FROM 
.. .OF set 

FOR EACH...FROM 
...OF set. ..REVERSE 
FOR EACH. ..AFTER 
.. .OF set 

FOR EACH...AFTER 
...OF set...REVERSE 

Automatic checking 


F L P S M N 


ROUTINES 

REQUIRED 


FF 

FL 

FB 

: A 

}F 

1L 

RS 

FF 

FF 

FF 

_ L 

FL 

FL 

FB 

FA 

_ 

RF 

RF 

RF 

RF 

RL 

RS 
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Statistical Keywords for ACCUMULATE Statement 

STATISTICAL 

KEYWORD 

SYNONYM 

COMPUTATION 

REQUIRED 

COUNTERS 

NUMBER 

NUM 

N 

N 

SUM 


ZX*(TIME.V-T l ) 

sum,t l 

MEAN 

AVG 

AVERAGE 

SUM/OTIME.V-Tq) 

sum,t l , T q 

SUM.OF.SQUARES 

SSQ 

2X 2 *{TIME.V-T l ) 

ssq,t l 

MEAN.SQUARE 

MSQ 

SSQ/(TIME.V-T q ) 

ssq,t l ,t 0 

VARIANCE 

VAR 

MSQ-MEAN 2 

ssq,sum,t l ,t 0 

STD.DEV 

STD 

SQRT.F(VAR) 

SSQ, SUM, T l , T q 

MAXIMUM 

MAX 

M = maximum (X) for 
all X 

M, N 

MINIMUM 

MIN 

m = minimum (X) for 
all X 

m, N 

NOTES: 




TIME.V 

current simulated time 


t l 

simulated time at which variable was set to its 
current value 

T 0 

simulated time at which accumulation started 

X 

sample value of accumulation variable (before it 
changes to a new value) 
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Statistical Keywords for TALLY Statement 


STATISTICAL 

KEYWORD 

SYNONYM 

COMPUTATION 

REQUIRED 

COUNTERS 

NUMBER 

NUM 

N 

N 

SUM 


2X 

SUM 

MEAN 

AVG 

AVERAGE 

SUM/N 

SUM, N 

SUM.OF.SQUARES 

SSQ 

2X 2 

SSQ 

MEAN.SQUARE 

MSQ 

SSQ/N 

SSQ, N 

VARIANCE 

VAR 

MSQ-MEAN 2 “ 

SSQ, SUM, N 

STD.DEV 

STD 

SQRT.F(VAR) 

SSQ, SUM, N 

MAXIMUM 

MAX 

M = maximum (X) 
for all X 

M, N 

MINIMUM 

MIN 

m = minimum (X) 
for all X 

m, N 


NOTE: X is the sample value of tallied variable (before it changes to a 
new value). 
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Statement 

Type 

Statement 

Rules 

la 

NORMALLY 

Can appear anywhere in preamble. 

lb 

DEFINE TO MEAN 


lc 

SUBSTITUTE 


Id 

SUPPRESS SUBST. 


le 

RESUME SUBST. 


If 

GENERATE 

INHIBIT 


2a 

TEMPORARY ENTITIES 

A preamble may contain many 

2b 

PERMANENT ENTITIES 

Type 2a, 2b, and 2c statements. 

2c 

EVENT NOTICES 

Each may be followed by a group 
of Type 3a, 4, and 5 statements. 

3a 

EVERY 

Many can follow a Type 2 state- 

3b 

THE SYSTEM 

ment. An entity or event notice 
name can appear in more than 
one EVERY statement. 

4 

DEFINE VARIABLE 

No precedence relation if it defines 
a global variable. 

Must follow all Type 3a statements 
if it defines an attribute named in 
them. 

A variable, attribute, or function 
name can appear in only one 
DEFINE statement. 

5 

DEFINE SET 

Must follow Type 4 statements in 
a Type 2 statement group if it 
qualifies a set named in them. 

6a 

BREAK TIES 

One statement allowed for each 

6b 

EXTERNAL EVENTS 

event notice. 

6c 

EXTERNAL UNITS 


7 

PRIORITY 

Must follow all Type 2c and 6b 
statements. 

8a 

BEFORE 

Allowed for each temporary 

8b 

AFTER 

entity, set, and event notice. 

9a 

TALLY 

Either TALLY or ACCUMULATE 

9b 

ACCUMULATE 

statistics but not both, may be 
specified for unsubscripted global 
variables, attributes of permanent 
or temporary entities, event 
notices, processes or resources. 


Of these statements, only Types 1 and 4 can be used in routines to 
declare local background conditions, variables, and substitutions. 
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SYSTEM DEFINED NAMES 


SYSTEM DEFINED VALUES 

Variable Mode Description Defalt 


BETWEEN.V 

Subprogram 

Subprogram variable called 
before each event is 
executed. 

0 

BUFFER.V 

Integer 

The length of the internal 
buffer. 

132 

EOF.V 

Integer 

End-of-file code; zero denotes 
notes that an end-of-file 
marker is an error; one 
indicates return control with 
EOF.V set to 2 when end- 
of-file is encountered; one 
for each input unit.tt 

0 

EVENT .V 

Integer 

Code representing the 
event class to occur next. 

0 

EVENTS.V 

Integer 

The number of event classes. 

0 

F.EV.S(*) 

Integer 

Array containing the first- 
in-set pointers for the event 
set, EV.S 

0 

HEADING.V 

Integer 

A subprogram variable tested 
by the system for each new 

page.tt 

0 

HOURS .V 

Real 

Number of hours per simu¬ 
lated day. 

24 

LINE.V 

Integer 

Number of the current 
output line.iT 

1 

LINES .V 

Integer 

Number of lines per page.tt 

55 

LEVS {*) 

Integer 

Array containing the last-in-set 
pointers for the event set EV.S 

0 

MARK.V 

Alpha 

Termination character 
required on external event 
cards and on the input for 
random variables. 

* 

MINUTES .V 

Real 

Number of minutes per 
simulated hour. 

60 


tt A separate value is maintained for each unit; only the currently used 
value is accessible to the program.____ 
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Variable 

Mode 

Description Default 

N.EV.S (n) 

Integer 

Function returning the number of 
pending event notices of class n. 


PAGE.V 

Integer 

Number of the current 

page.tt 

1 

PAGECOL.V 

Integer 

If =£ 0, column number in 
which the word PAGE and 
the value of PAGE.V is to 

0 



be printed on the output 

listing tt 


PARM.V M 

Alpha 

Array countaining the user 
parameters passed to the program. 


PRMB.V (*) 

Integer 

Array countaining the values of 
the attributes of THE SYSTEM 
with IN WORD clauses. 


RCOLUMN.V 

Integer 

Pointer to the last column 
read in the input buffer.tt 

0 

READ.V 

Integer 

Number of the current 
input unit. 

5 

RECORD. V(n) 

Integer 

The number of records read 
from or written on the 
indicated unit. 

0 

RRECORD.V 

Integer 

The number of records read 
from the current input unit.tt 

0 

SEED.V 

Integer 

Array containing initial ran¬ 
dom numbers. 

Yes 

TIME.V 

Real 

Current simulated time. 

0 

WCOLUMN.V 

Integer 

Pointer to the column last 
written in the output buffer.tt 

0 

WRECORD.V 

Integer 

The number of records 
written on the current out¬ 
put unit.tt 

0 

WRITE. V 

Integer 

Number of the current output 
unit. 

6 


tt A separate value is maintained for each unit; only the currently used 
value is accessible to the program._ 
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SYSTEM DEFINED CONSTANTS 

Constant 

Mode 

Description 

EXP.C 

Real 

2.7182818284590452 

INF.C 

Integer 

Largest INTEGER value that can 
be stored. 

PI.C 

Real 

3.1415926535897932 

RADIAN .C 

Real 

57.295779513082321 degrees/ 
radian 

RINF.C 

Real 

Largest REAL value that can be 
stored. 


I 

I i 
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SYSTEM DEFINED FUNCTIONS 

Function 

Mnemonic 

Arguments^ 

Function 

Mode 

Description 

ABS.F 

e 

Mode of e 

Returns the absolute 
value of the expres¬ 
sion. 

ALPHA.F 

a,b 

Integer 

Compares two 
alphanumeric words a 
and b and returns: 

—1 if a<b 

Oif a = b 

1 if a>b 

AND.F 

a,b 

Integer 

Logical product of a 
and b. 

ARCCOS.F 

e 

Real 

Computes the arc 
cosine of a real ex¬ 
pression;-^ e > 1 

ARCTAN.F 

e l» e 2 

Real 

Computes the arc tan¬ 
gent of ei/e 2 ;(ei,e 2 ) 
*(0.0) 

BETA.F 

ei>«2.e3 

Real 

Returns a random 
sample from a beta 
distribution 
ei = power of x, real; 

ei>0 

e 2 = power of (1-x), 
real; e 2 > 0 
e 3 = random number 
stream, integer 

BINOMIAL.F 

e l> e 2> e 3 

Integer 

Returns a random 
sample from a bi¬ 
nomial distribution 

ei = number of trials, 
integer 

e 2 = probability of 
success, real 

e 3 = random number 
stream, integer 

COS.F 

e 

Real 

Computes the cosine 
of a real expression 
given in radians. 

te = expression that can be of any complexity, including functions 
v = variable 
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DATE.F 

e lj e 2> e 3 

Real 

Converts a calendar 
date to cumulative 
simulation time, 
based on values 
given to ORIGIN.R 

ei = month, integer 
e 2 - day, integer 

e 3 = year, integer 

DAY.F 

e 

Integer 

Converts simulation 
time to the day por¬ 
tion based on values 
given to ORIGIN.R 

e = cumulative 

simulation time, 
real 

DIM.F 

v(*) 

Integer 

Returns the number 
of elements pointed 
to by the pointer 
variable v, in the 
dimension of the 
array v. 

DIV.F 

e l> e 2 

Integer 

Returns the trun¬ 
cated value of (ej /e 2 ) 

ei= dividend, 
integer 

e 2 = divisor, integer; 

e2 # 0 

EFIELD.F 

none 

Integer 

Returns the ending 
column of the next 
data Field to be read 
by a READ Free 

Form statement. 

ERLANG.F 

ei,e2,es 

Real 

Returns a sample 
value from an Erlang 
distribution 

ei = mean, real 
e 2 = k, integer 

e 3 = random num¬ 
ber stream, integer 
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Function 

Mnemonic 

Arguments 

Function 

Mode 

Description 

EXP.F 

e 

Real 

Computes EXP.C 
to the eth power; 
e must be real. 

EXPONEN¬ 

TIALS 

e l> e 2 

Real 

Returns a random 
sample from an ex¬ 
ponential distribu¬ 
tion 

ei = mean, real 

e 2 = random number 
stream, integer 

FRAC.F 

e 

Real 

Returns the fractional 
portion of a real ex¬ 
pression. 

GAMMA.F 

e l> e 2> e 3 

Real 

Returns a random 
sample from a gamma 
distribution 

ei = mean, real 

e 2 = k, real 

e 3 = random number 
stream, integer 

GAMMAJ.F 

e l> e 2> e 3 

Real 

Same as GAMMAS 

HOURS 

e 

Integer 

Converts event time 
to the hour portion 

e = cumulative 
event time, 
real 

INTS 

v,e 

Integer 

Returns the rounded 
integer portion of a 
real expression. 

ISTEPS 

v, e 

Integer 

Returns a random 


sample from a look-up 
table without inter¬ 
polation 

v = variable that 
points to the 
look-up table 

e = random number 
stream, integer 
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Function 

Mnemonic 


Arguments 


Function Descri ption 
Mode 


iTOA.F e Alpha 


LIN.F v, e Real 


LOG.E.F e Real 


LOG. e l5 e 2 ,e 3 Real 

NORMAL.F 


LOG.IO.F e Real 


Converts an integer 
expression to an 
alpha-numeric value, 
left adjusted in a 
blank field. 

Returns a random 
sample from a 
look-up table, 
using linear inter¬ 
polation 

v = variable that 
points to the 
look-up 
table 

e = random num¬ 
ber stream 
integer 
Computes the 
natural logarithm 
of a real expression 
e> 0. 

Returns a random 
sample from a 
lognormal distri¬ 
bution 

ej = mean, real 
e 2 ~ standard devia¬ 
tion, 

e 3 = random num¬ 
ber stream, 
integer 

Computes log 10 of 
a real expression; 
e > 0. 


MASK.F 


Integer Builds a left 
justified mask 
of e bits. 
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Function 

Mnemonic 

Arguments 

Function 

Mode 

Description 

MAX.F 

ei,e2,. .e„ 

Real if any 
e/ real; if 
none, 
integer 

Returns the value of 
the largest e,\ 

MIN.F 

e l > e 2> • • 

Real if any 
e,- real; if 
none, 
integer 

Returns the value of 
the smallest e/. 

MINUTE .F 

e 

Integer 

Converts event time 
to .the minute 
portion 

e = cumulative 
event time, 
real 

MOD.F 

e l j e 2 

Real if 
either e,- 
real; if 
none, 
integer 

Computes a remain¬ 
der as 

ei-TRUNCJF(ei /e 2 ) 

*e 2 ; 

62=^0 

MONTH.F 

e 

Integer 

Converts simulation 
time to month portion 
based on values given 
to ORIGIN.R 

e = cumulative simu¬ 
lation time, real 

NDAY.F 

e 

Integer 

Converts event time 
to the day portion 

e = cumulative event 
time, real 

NORMAL.F 

e l> Q 2> e 3 

Real 

Returns a random 
sample from a normal 
distribution 

ej = mean, real 

e 2 = standard devia¬ 
tion, real 

e 3 = random number 
stream, integer 

OR.F 

a, b 

Integer 

Logical sum of a and 
b. 
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Function 

Mnemonic 

Arguments 

Function 

Mode 

Description 

OUT.F 

e 

Alpha 

Sets or returns the 
alphanumeric value 
of the e th character 
in the current output 
buffer; e must yield 
an integer value; 
e 5*0; both right- 
and left-handed 
function. 

POISSON.F 

e l> e 2 

Integer 

Returns a random 
sample from a Poisson 
distribution 

ej = mean, real 

e 2 = random num¬ 
ber stream, 
integer 

RANDI.F 

ei,e2,e3 

Integer 

Returns a random 
sample uniformly 
distributed between 
a range of values 

ei = beginning value, 
integer 

e 2 = ending value, 
integer 

e 3 = random num¬ 
ber stream, 
integer 

RANDOM.F 

e 

Real 

Returns a pseudo¬ 
random number 
between zero and 

one 

e = random num¬ 
ber stream, 
integer 

REAL.F 

e 

Real 

Converts an integer 
expression to a real 
value. 
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Function 

Mnemonic 

Argument 

Function 

Mode 

Description 

RSTEP.F 

v, e 

Real 

Returns a random 
sample from a look¬ 
up table 

v = variable that 
points to the 
look-up table 

e = random num¬ 
ber stream, 
integer 

SFIELD.F 

none 

Integer 

Returns the starting 
column of the next 
data field to be read 
by a READ Free Form 
statement. 

SHL.F 

w, n 

Integer 

Shift w left n posi¬ 
tions, end around. 

SHR.F 

w, n 

Integer 

Shift w right n posi¬ 
tions, arithmetic. 

SIGN.F 

e 

Integer 

Indicates the sign of 
a real expression. 

1 if e > 0 

0 if e = 0 

-1 if e <0 

SIN.F 

e 

Real 

Computes the sine of 
a real expression 
given in radians. 

SQRT.F 

e 

Real 

Computes the square 
root of a real expres¬ 
sion; e >0. 

TAN.F 

e 

Real 

Computes the tangent 
of a real expression 
given in radians. 

TRUNC.F 

e 

Integer 

Returns the truncated 
integer value of a real 
expression. 
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Function 

Mnemonic 

Arguments 

Function 

Mode 

Description 

UNIFORM.F 

ei,e 2 ,e 3 

Real 

Returns a uniformly 
distributed random 
sample between a 
range of values 

ei = beginning value, 
real 

e 2 = ending value, 
real 

e 3 = random number 
stream, integer 

WEEKDAY.F 

e 

Integer 

Converts event time 
to the weekday por¬ 
tion 

e = cumulative 

event time, real 

WEIBULL.F 

e l> e 2> e 3 

Real 

Returns a sample 
value from a Weibull 
distribution 

ej = scale parameter, 
real 

e 2 = shape parameter, 
real 

e 3 = random number 
stream, integer 

XOR.F 

a, b 

Integer 

Logical difference of 
a and b. 

YEAR.F 

e 

Integer 

Converts simulation 
time to the year por¬ 
tion based on values 
given to ORIGIN.R 

e = cumulative 

simulation time, 
real 

ZTIME.F 

none 

Real 

Returns the elapsed 
execution time in 
seconds. 
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SYSTEM DEFINED ROUTINES 


Routine 

Arguments 

Description 

ORIGIN.R 

e l> e 2> e 3 

Establishes an origin time 
when the calendar format 
is used 

ei = month, integer 

e 2 = day, integer 

e 3 = year, integer 

TIME.R 

none 

Controls simulation timing 
and selects events. 

SNAP.R 

none 

User supplied routine called 
by SIMSCRIPT II.5 when an 
execution error is detected. 

DATE.R 

yi,Y2 

Yields the current date and 
current time of day from 
the operating system. 

yi = date, alpha 
y 2 = time, alpha 

EOFR 

e 

Writes an end of file on logical 
unit e. 

EXIT.R 

e 

Stops the simulation after 
printing EXIT e and issuing 
a traceback. 

MOVE.F 

v l’ v 2’ n 

Move n words 
from one storage 
area to another. 

v^ = Base pointer 
of source 
array 

Vj = Base pointer 
of target array 

n = Number of 
words 
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GENERATED VARIABLES, ATTRIBUTES AND ROUTINES 


Generated 

Generated 

Name 

Definition 

for 

Elements 

Accumulated 

Routine 

Q. variable 

A left-hand monitor- 

and tallied 



ing routine that 

variables 



accumulates or 
tallies data 

Entities 

Variables 

Gentity* 

Global variable hav- 

(5 unique 



ing the entity class 

characters) 



name 



N.entity 

No. of entities of 
the entity class 
(permanent entities 
only) 



K.entity 

Size of entity in 
computer words 
(temporary entities 
only) 


Routines 

C. entity 

To reserve storage 
for permanent enti¬ 
ties (i.e., to create 
them) 



D.entity 

Called when destroy¬ 
ing a temporary 




entity to check for 
set membership error 



A.entity 

Called to list the 
values of entity 
attributes 

Event Notices 

Variables 

Gevent* 

Global variable hav¬ 

(5 unique 



ing the event notice 

characters) 



name 



I.event 

Global variable hold¬ 
ing the subscript for 
this event class in 
the event set 

♦The G prefix entry name is generated only when a word or array number is not 

specified for the indicated name. 

If this entry is not generated, and associated 

routine and variable names are not present, there is no restriction on the length 

| of the name. 
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Generated 

Generated 

Name 


for 

Elements 

Definition 



K.event 

Size of the event 
notice in computer 
words 


Routines 

C.event 

Files events, whose 
priorities are declared 
in BREAK TIES 
statements, in the 
proper event set 



D.event 

Called when destroy¬ 
ing event notice to 
check for set mem¬ 
bership error 



A.event 

Called to list values 
of event notice 
attributes 

Event notice 

Attributes 

TIME .A 

Time event is to 

Records 



occur 



EUNIT.A 

Equals 0 for an endog¬ 
enous event; equals 
input unit number 
(¥= 0) for an exog¬ 




enous event 



P.EV.S 

Pointer to predecessor 
event in the event set 



S.EV.S 

Pointer to successor 
event in the event set 



M.EV.S 

Set to 1 if the event 
is in the set; set to 0 
if the event is not in 
the set 

Random 

Attributes 

PROB.A 

Probability value 

Variables 

of RANDOM JE 

IVALUE.A 

Sample value: 



RVALUE .A 

IVALUE.A contains 
an integer value; 
RVALUE.A con¬ 
tains a real value 



S. variable 

Pointer to successor 
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Generated 

for 

Generated 

Elements 

Name 

Definition 

Sets 

Attributes of 

F.set 

Pointer to first entity 

(5 unique 

owner entities 


in set 

characters) 


L.set 

Pointer to last entity 
in set 



N.set 

No. of entities 
currently in the set 


Attributes of 

P.set 

Pointer to predecessor 


member enti- 


entity in set 


ties 

S.set 

Pointer to successor 
in set 



M.set 

Equals 1 if the entity 
is in the set; equals 0 
if the entity is not in 
the set 


Routines 

T.set 

Files entity first or 
ranked in set 



U.set 

Files entity last in 
set 



V.set 

Files entity before 
specified entity in 
set 



W.set 

Files entity after 
specified entity in 
set 



X.set 

Removes first entity 
from set 



Y.set 

Removes last entity 
from set 



Z.set 

Removes specific 
entity from set 
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SIM 115 COMPILATION CONTROL CARD 


j SIMII5. 1 

| SIMII5, pj, p 2 , p 3 , p 4 , p 5 , p 6 , p 7 , p 8 . ( 

All the p i parameters are order independent. 


— p. . Source input 

. absent 

INPUT assumed 


. I = lfn 

Source input on file lfn 

— p 2 . Binary out¬ 
put 

. absent 

LGO assumed 

. B = lfn 

Relocatable binary on file lfn 


. B = 0 

No binary output 

— pg . Source listing 

. absent 
. L = OUTPUT 

Source listing on file OUTPUT 


. L = 0 

Suppresses listing output 
except for errors 


r 

ii 

3* 

Source listing on file lfn 

— p 4 . Star, allstai 

. absent 

No listing 

and object 

. S = lfn 

Star listing on file lfn 

listing 

. 0= lfn 

Object listing on file lfn 


. A= lfn 

Allstar listing on file 1 fn 


. OS = lfn 

Star and object listing on 
file 1 fn 


. AO - 1 fn 

Allstar and object listing on file 1 fn 

— p^ . Compilation 

. OPT = fif 9 . ..f n 


options 

i 

H 

11 

Generate line numbers for 
traceback 


II 

*0 

Continue compilation even 
if errors are detected in the 
PREAMBLE 


. fi = E 

Do not abort the job if com¬ 
pilation errors are detected 


. fi = 8 

Print output at 8 lines/inch 


. fi =6 

Print output at 6 lines/inch 


. fi =N 

Suppress listing of the PREAMBLE 


. fi — C 

Compress source listing 


. fi = V 

Use small buffers for compilation 

— pg . Last column 

. LC = n 

Last card column to be 
scanned by the compiler 

~ p 7 . Symbolic 

. absent 

R= 1 

reference 

. R= 1 

Local map, no line numbers 

map 

. R= 2 

Global map, no line numbers 


. R = 3 

Local and global map, 
no line numbers 


. R = 4 

Global map with line numbers 


. R = 5 

Local map, no line numbers 

Global map with line numbers 
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. R =6 
. R= 7 

. R = 8 

Pg . Structured . absent 
IF 

. IF = OLD 


Local map with line numbers 
Local map with line numbers 
Global map, no line numbers 
Local and global map with 
line numbers 

IF = NEW (i.e. new IF-ELSE- 
ALWAYS construct) 
Unstructured IF 


Examples: 

SIMII5. 

— Source input on INPUT 
— Source listing on OUTPUT 
— Relocatable binary on LGO 
— No star or assembly listings 
— No line numbers 


— Abort job if errors in the 
PREAMBLE or compilation 
errors 

— Last column = 80 

— IF = NEW and R = 1 


SIM 115,1 = COMPILE, LS = OUTPUT, OPT = PTE8, LC = 72. 

— Source input on file COMPILE 

— Source listing and star listing on file OUTPUT (Note: If all the list¬ 
ings are directed to the same file, the options can be merged) 

— Continue compilation even if errors are detected in the PREAMBLE 

— Include line numbers for traceback 

— Execute the program even if compilation errors occurred 

— Print the listings at 8 lines/inch 

— Last column = 72. 
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SIMII5 EXECUTION CONTROL CARD 

| LGO. } 

\ LGO, f l5 f 2 ,.. .f n , p p p 2 , p 3 J 

f . fj, £" 2 * - -. f n External file name substitution 

SIMUn = lfn 

n = internal logical unit number 0 < n < 9 

— even numbered units are carriage 

I* control files 

— odd numbered units are non-slew 
BCD files 

— any unit number can be used for 
binary files, (except 5 and 6) 

lfn = external file name 
FORTRAN file name definition 
TAPEn = lfn 

FTN routines must be compiled with 
SYSEDIT = FILES 
All files used by FORTRAN must be 
declared. 

FORTRAN cannot share SIM SC RIFT 
files. 

PL = n n is the maximum number of 
decimal lines to print on the 
OUTPUT file (default: 10000) 

DS = n n is the octal or decimal number 
of words reserved initially for 
dynamic storage. Assumed octal. 
(Ex: 4000 or 4000B, 10000D) 

PARM = gp g 2 ,-g n ; 

gj represents either a single value or 
a group of values separated by an =, 
a+or a— sign. 

- SIMU5 = INPUT 

- SIMU6 - OUTPUT 

- No FORTRAN files 
— Print limit on output = 10000 

INPT, SIMU8 = REPORT, PL = 15000, DS = 20000B. 
— Input on file INPT 

- SIMU6 = OUTPUT 

- Additional file SIMU8 = REPORT 

- Print limit on OUTPUT = 15000 lines 
— Initial dynamic storage = 20000B 




Examples: 

LGO. 


LGO, SIMU5 = 


. pj — Print limit 


. P 2 — Dynamic storage 


. P 3 — User parameters 
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CHARACTER SET 



Hollerith (026) and ASCII (029) punches are accepted for 
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